<html>
<head><meta charset="utf-8"><title>high-level docs · wg-traits · Zulip Chat Archive</title></head>
<h2>Stream: <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/index.html">wg-traits</a></h2>
<h3>Topic: <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html">high-level docs</a></h3>

<hr>

<base href="https://rust-lang.zulipchat.com">

<head><link href="https://rust-lang.github.io/zulip_archive/style.css" rel="stylesheet"></head>

<a name="135871161"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/135871161" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> tmandry <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#135871161">(Oct 16 2018 at 01:43)</a>:</h4>
<p>I wrote down some ideas I had in <a href="https://github.com/rust-lang/rust/issues/55100#issuecomment-430071173" target="_blank" title="https://github.com/rust-lang/rust/issues/55100#issuecomment-430071173">this issue comment</a><br>
cc <span class="user-mention" data-user-id="116009">@nikomatsakis</span> <span class="user-mention" data-user-id="117350">@Sunjay Varma</span></p>



<a name="135871205"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/135871205" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> tmandry <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#135871205">(Oct 16 2018 at 01:44)</a>:</h4>
<p>although <span class="user-mention" data-user-id="116009">@nikomatsakis</span> you may have had more developed ideas</p>



<a name="135872239"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/135872239" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Sunjay Varma <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#135872239">(Oct 16 2018 at 02:15)</a>:</h4>
<p>I replied to your issue comment :)</p>



<a name="135872240"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/135872240" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Sunjay Varma <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#135872240">(Oct 16 2018 at 02:15)</a>:</h4>
<p>Great ideas! :D</p>



<a name="136111914"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136111914" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> scalexm <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136111914">(Oct 19 2018 at 13:41)</a>:</h4>
<p><span class="user-mention" data-user-id="116009">@nikomatsakis</span> <span class="user-mention" data-user-id="116883">@tmandry</span> <span class="user-mention" data-user-id="117350">@Sunjay Varma</span> I finished writing the implied bounds chapter in the rustc guide <a href="https://github.com/rust-lang-nursery/rustc-guide/pull/212" target="_blank" title="https://github.com/rust-lang-nursery/rustc-guide/pull/212">https://github.com/rust-lang-nursery/rustc-guide/pull/212</a> , please tell me if it's understandable</p>



<a name="136112229"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136112229" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> nikomatsakis <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136112229">(Oct 19 2018 at 13:46)</a>:</h4>
<p>I'm at Rust Belt Rust today, btw.</p>



<a name="136112264"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136112264" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> nikomatsakis <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136112264">(Oct 19 2018 at 13:46)</a>:</h4>
<p>btw <span class="user-mention" data-user-id="116883">@tmandry</span> (and/or <span class="user-mention" data-user-id="117350">@Sunjay Varma</span>) — shall we schedule a slot next week to chat about high-level docs?</p>



<a name="136117238"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136117238" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Sunjay Varma <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136117238">(Oct 19 2018 at 15:06)</a>:</h4>
<p><span class="user-mention" data-user-id="116009">@nikomatsakis</span> Yes. Monday or Friday would be best for me. Monday at 2:30 EST or Friday anytime after 2 pm EST</p>



<a name="136117265"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136117265" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Sunjay Varma <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136117265">(Oct 19 2018 at 15:06)</a>:</h4>
<p>Next week is particularly busy because of interviews, so if neither of those work I should have more time the week after that. <span class="emoji emoji-1f60a" title="blush">:blush:</span></p>



<a name="136237900"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136237900" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> tmandry <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136237900">(Oct 22 2018 at 01:12)</a>:</h4>
<p><span class="user-mention" data-user-id="131694">@scalexm</span> Looks good! I started reviewing but github is screwed up right now and I can't post anything <span class="emoji emoji-1f611" title="expressionless">:expressionless:</span></p>



<a name="136556685"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136556685" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> tmandry <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136556685">(Oct 26 2018 at 16:07)</a>:</h4>
<p>btw <span class="user-mention" data-user-id="131694">@scalexm</span> <span class="user-mention" data-user-id="116009">@nikomatsakis</span> <span class="user-mention" data-user-id="117350">@Sunjay Varma</span> I don't know if you saw <a href="https://github.com/rust-lang-nursery/rustc-guide/pull/219" target="_blank" title="https://github.com/rust-lang-nursery/rustc-guide/pull/219">https://github.com/rust-lang-nursery/rustc-guide/pull/219</a></p>



<a name="136558762"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136558762" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> scalexm <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136558762">(Oct 26 2018 at 16:44)</a>:</h4>
<p><span class="user-mention" data-user-id="116883">@tmandry</span> ah very nice</p>



<a name="136561144"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136561144" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Sunjay Varma <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136561144">(Oct 26 2018 at 17:23)</a>:</h4>
<p><span class="user-mention" data-user-id="116883">@tmandry</span> thanks for working on that! Looks great!</p>



<a name="136561677"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136561677" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> nikomatsakis <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136561677">(Oct 26 2018 at 17:33)</a>:</h4>
<p><span class="user-mention" data-user-id="116883">@tmandry</span> I did not yet, but i'm excited to read it</p>



<a name="136561701"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136561701" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> tmandry <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136561701">(Oct 26 2018 at 17:33)</a>:</h4>
<p>it's mostly light edits and reorganizing, not much new content yet :)</p>



<a name="136561795"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136561795" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> tmandry <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136561795">(Oct 26 2018 at 17:34)</a>:</h4>
<p>so <span class="user-mention" data-user-id="116009">@nikomatsakis</span> and I spoke at RBR last week, and I put together a list of "action items" that I think covers what we talked about</p>



<a name="136561817"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136561817" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> tmandry <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136561817">(Oct 26 2018 at 17:35)</a>:</h4>
<p>how about if I post those on the issue and we can tackle it "quest-style"</p>



<a name="136565410"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136565410" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> nikomatsakis <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136565410">(Oct 26 2018 at 18:32)</a>:</h4>
<p>sounds great!</p>



<a name="136565736"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136565736" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> tmandry <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136565736">(Oct 26 2018 at 18:39)</a>:</h4>
<p><span class="user-mention" data-user-id="116009">@nikomatsakis</span> ok, I <a href="https://github.com/rust-lang/rust/issues/55100#issuecomment-433504534" target="_blank" title="https://github.com/rust-lang/rust/issues/55100#issuecomment-433504534">posted them here</a>, please take a look and let me know if anything seems off</p>



<a name="136565824"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136565824" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> nikomatsakis <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136565824">(Oct 26 2018 at 18:40)</a>:</h4>
<p><span class="user-mention" data-user-id="116883">@tmandry</span> ps if you do the nit that <span class="user-mention" data-user-id="131694">@scalexm</span> recommended, I can merge your PR</p>



<a name="136566004"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136566004" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> tmandry <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136566004">(Oct 26 2018 at 18:43)</a>:</h4>
<p><span class="user-mention" data-user-id="116009">@nikomatsakis</span> pushed</p>



<a name="136567424"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136567424" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> nikomatsakis <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136567424">(Oct 26 2018 at 19:07)</a>:</h4>
<p>merged</p>



<a name="136728238"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136728238" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> tmandry <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136728238">(Oct 29 2018 at 19:11)</a>:</h4>
<p>we discussed the idea of linking to code more from the rustc guide, as a way of making things "more concrete"</p>



<a name="136728270"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136728270" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> tmandry <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136728270">(Oct 29 2018 at 19:11)</a>:</h4>
<p>..one problem is that we would link to old code (github permalinks can keep broken links from happening, but not from going stale)</p>



<a name="136728326"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136728326" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> tmandry <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136728326">(Oct 29 2018 at 19:12)</a>:</h4>
<p>thankfully, we have <a href="https://doc.rust-lang.org/nightly/nightly-rustc/rustc/" target="_blank" title="https://doc.rust-lang.org/nightly/nightly-rustc/rustc/">nightly-rustc</a> docs!</p>



<a name="136728356"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136728356" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> tmandry <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136728356">(Oct 29 2018 at 19:13)</a>:</h4>
<p>I propose we start linking to these throughout rustc-guide..</p>



<a name="136728369"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136728369" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> tmandry <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136728369">(Oct 29 2018 at 19:13)</a>:</h4>
<p>it would be nice to have them for chalk, too (<code>--document-private-items</code> needs to be turned on)</p>



<a name="136728639"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136728639" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Sunjay Varma <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136728639">(Oct 29 2018 at 19:18)</a>:</h4>
<p>Do the private items in chalk have sufficient documentation?</p>



<a name="136728642"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136728642" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Sunjay Varma <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136728642">(Oct 29 2018 at 19:18)</a>:</h4>
<p>That might also be a good place for improvement</p>



<a name="136728643"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136728643" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> tmandry <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136728643">(Oct 29 2018 at 19:18)</a>:</h4>
<p>not yet :)</p>



<a name="136728649"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136728649" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Sunjay Varma <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136728649">(Oct 29 2018 at 19:19)</a>:</h4>
<p>Making the code more readable with some comments</p>



<a name="136728650"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136728650" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Sunjay Varma <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136728650">(Oct 29 2018 at 19:19)</a>:</h4>
<p>:D</p>



<a name="136728674"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136728674" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> tmandry <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136728674">(Oct 29 2018 at 19:19)</a>:</h4>
<p>agreed</p>



<a name="136728692"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136728692" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> tmandry <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136728692">(Oct 29 2018 at 19:19)</a>:</h4>
<p>well, some of it is pretty well documented iirc</p>



<a name="136728745"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136728745" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> tmandry <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136728745">(Oct 29 2018 at 19:20)</a>:</h4>
<p>in any case, if we get in the habit of making these links</p>



<a name="136728749"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136728749" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> tmandry <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136728749">(Oct 29 2018 at 19:20)</a>:</h4>
<p>hopefully it will become clear when there are improvements to be made</p>



<a name="136729238"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136729238" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> tmandry <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136729238">(Oct 29 2018 at 19:29)</a>:</h4>
<p>..so, hosting docs with <code>--document-private-items</code> might be difficult</p>



<a name="136729265"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136729265" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> tmandry <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136729265">(Oct 29 2018 at 19:29)</a>:</h4>
<p>the easiest way I can see is using GitLab CI</p>



<a name="136729331"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136729331" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Sunjay Varma <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136729331">(Oct 29 2018 at 19:30)</a>:</h4>
<p>Is it possible to do during the existing Travis build?</p>



<a name="136729352"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136729352" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> tmandry <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136729352">(Oct 29 2018 at 19:31)</a>:</h4>
<p>building is possible, but I'm not sure where to host</p>



<a name="136729369"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136729369" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Sunjay Varma <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136729369">(Oct 29 2018 at 19:31)</a>:</h4>
<p>On GitHub pages?</p>



<a name="136729373"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136729373" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Sunjay Varma <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136729373">(Oct 29 2018 at 19:31)</a>:</h4>
<p>gh-pages branch of the chalk repo?</p>



<a name="136729431"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136729431" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> tmandry <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136729431">(Oct 29 2018 at 19:32)</a>:</h4>
<p>I looked at that, but it seems that it forces you to use Jekyll. do you know if you can stick raw HTML in there?</p>



<a name="136729472"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136729472" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Sunjay Varma <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136729472">(Oct 29 2018 at 19:33)</a>:</h4>
<p>Yes. You can actually use it without having to interact with Jekyll at all</p>



<a name="136729482"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136729482" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Sunjay Varma <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136729482">(Oct 29 2018 at 19:33)</a>:</h4>
<p>That's just if you need to do any fancy stuff</p>



<a name="136729489"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136729489" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> tmandry <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136729489">(Oct 29 2018 at 19:33)</a>:</h4>
<p>oh okay, my bad. we can do that then</p>



<a name="136729546"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136729546" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Sunjay Varma <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136729546">(Oct 29 2018 at 19:34)</a>:</h4>
<p><a href="https://github.com/sunjay/maze-generator/tree/gh-pages?files=1" target="_blank" title="https://github.com/sunjay/maze-generator/tree/gh-pages?files=1">https://github.com/sunjay/maze-generator/tree/gh-pages?files=1</a></p>



<a name="136729552"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136729552" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Sunjay Varma <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136729552">(Oct 29 2018 at 19:34)</a>:</h4>
<p>A really old repo of mine with just some simple HTML and CSS</p>



<a name="136729555"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136729555" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Sunjay Varma <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136729555">(Oct 29 2018 at 19:34)</a>:</h4>
<p>No need to interact with Jekyll at all :)</p>



<a name="136730387"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136730387" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> tmandry <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136730387">(Oct 29 2018 at 19:50)</a>:</h4>
<p><span class="user-mention" data-user-id="116009">@nikomatsakis</span> what do you think about putting chalk private docs in gh-pages?</p>



<a name="136730457"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136730457" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> tmandry <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136730457">(Oct 29 2018 at 19:50)</a>:</h4>
<p>also, do you have access to Travis? I can send you the instructions for adding an access token</p>



<a name="136731093"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136731093" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> nikomatsakis <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136731093">(Oct 29 2018 at 20:00)</a>:</h4>
<blockquote>
<p>thankfully, we have <a href="https://doc.rust-lang.org/nightly/nightly-rustc/rustc/" target="_blank" title="https://doc.rust-lang.org/nightly/nightly-rustc/rustc/">nightly-rustc</a> docs!</p>
</blockquote>
<p>yep, this is what I tend to link to</p>



<a name="136731116"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136731116" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> nikomatsakis <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136731116">(Oct 29 2018 at 20:00)</a>:</h4>
<blockquote>
<p>what do you think about putting chalk private docs in gh-pages?</p>
</blockquote>
<p>sounds good to me</p>



<a name="136731124"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136731124" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> nikomatsakis <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136731124">(Oct 29 2018 at 20:00)</a>:</h4>
<blockquote>
<p>also, do you have access to Travis? I can send you the instructions for adding an access token</p>
</blockquote>
<p>I do</p>



<a name="136731157"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136731157" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> nikomatsakis <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136731157">(Oct 29 2018 at 20:01)</a>:</h4>
<p>I can figure it out, but I would love it if you are able to send me what to do :) I always have to go figure this stuff out again afresh and I hate doing it</p>



<a name="136731178"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136731178" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> tmandry <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136731178">(Oct 29 2018 at 20:01)</a>:</h4>
<p>no problem, give me one second :)</p>



<a name="136731682"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136731682" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> tmandry <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136731682">(Oct 29 2018 at 20:09)</a>:</h4>
<p><span class="user-mention" data-user-id="116009">@nikomatsakis</span> sent you PMs</p>



<a name="136731974"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136731974" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> tmandry <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136731974">(Oct 29 2018 at 20:13)</a>:</h4>
<p>hmm, do we want to generate docs for dependencies?</p>



<a name="136732065"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136732065" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> tmandry <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136732065">(Oct 29 2018 at 20:14)</a>:</h4>
<p>to start I'm leaning toward no, but if anyone thinks it might be helpful we can add them</p>



<a name="136732146"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136732146" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Sunjay Varma <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136732146">(Oct 29 2018 at 20:15)</a>:</h4>
<p>I believe there is something that <a href="http://docs.rs" target="_blank" title="http://docs.rs">docs.rs</a> does that allows it to link externally to outside crates</p>



<a name="136732150"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136732150" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Sunjay Varma <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136732150">(Oct 29 2018 at 20:15)</a>:</h4>
<p>Helps them de-dupe the docs</p>



<a name="136732152"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136732152" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Sunjay Varma <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136732152">(Oct 29 2018 at 20:15)</a>:</h4>
<p>I am not sure how it works though</p>



<a name="136732160"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136732160" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Sunjay Varma <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136732160">(Oct 29 2018 at 20:15)</a>:</h4>
<p>Just that it is probably possible</p>



<a name="136732166"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136732166" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Sunjay Varma <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136732166">(Oct 29 2018 at 20:15)</a>:</h4>
<p>We also apparently do that for std docs</p>



<a name="136732176"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136732176" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Sunjay Varma <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136732176">(Oct 29 2018 at 20:16)</a>:</h4>
<p>Those are not generated with every crate</p>



<a name="136732447"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136732447" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> tmandry <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136732447">(Oct 29 2018 at 20:20)</a>:</h4>
<p><span class="user-mention" data-user-id="117350">@Sunjay Varma</span> okay, I don't see anything in the cargo doc help, but I'm sure there is a way :)</p>



<a name="136732576"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136732576" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Sunjay Varma <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136732576">(Oct 29 2018 at 20:21)</a>:</h4>
<p>I asked on Twitter: <a href="https://twitter.com/Sunjay03/status/1057004483220107266" target="_blank" title="https://twitter.com/Sunjay03/status/1057004483220107266">https://twitter.com/Sunjay03/status/1057004483220107266</a></p>
<div class="inline-preview-twitter"><div class="twitter-tweet"><a href="https://twitter.com/Sunjay03/status/1057004483220107266" target="_blank"><img class="twitter-avatar" src="https://pbs.twimg.com/profile_images/993971761501716480/IfIM3MnQ_normal.jpg"></a><p>Is there a way to generate docs for your <a href="https://twitter.com/rustlang" target="_blank" title="https://twitter.com/rustlang">@rustlang</a> project (for the purpose of hosting it online) where dependencies are automatically linked to something like <a href="https://t.co/UMuh9IJupg" target="_blank" title="https://t.co/UMuh9IJupg">http://docs.rs</a>?</p><span>- Sunjay (@Sunjay03)</span></div></div>



<a name="136732581"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136732581" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Sunjay Varma <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136732581">(Oct 29 2018 at 20:21)</a>:</h4>
<p>Hopefully someone knows :)</p>



<a name="136733021"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136733021" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Sunjay Varma <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136733021">(Oct 29 2018 at 20:28)</a>:</h4>
<p><a href="https://twitter.com/QuietMisdreavus/status/1057005767222534150" target="_blank" title="https://twitter.com/QuietMisdreavus/status/1057005767222534150">https://twitter.com/QuietMisdreavus/status/1057005767222534150</a></p>
<div class="inline-preview-twitter"><div class="twitter-tweet"><a href="https://twitter.com/QuietMisdreavus/status/1057005767222534150" target="_blank"><img class="twitter-avatar" src="https://pbs.twimg.com/profile_images/875056230485700611/_89Eo1QO_normal.jpg"></a><p><a href="https://twitter.com/killercup" target="_blank" title="https://twitter.com/killercup">@killercup</a> <a href="https://twitter.com/Sunjay03" target="_blank" title="https://twitter.com/Sunjay03">@Sunjay03</a> <a href="https://twitter.com/rustlang" target="_blank" title="https://twitter.com/rustlang">@rustlang</a> so <a href="https://t.co/LEd5jqH33x" target="_blank" title="https://t.co/LEd5jqH33x">http://docs.rs</a> just passes one of these arguments for each dep of a crate, and supplies the link for the version it's depending on</p><span>- grey was a ghost before it was cool (@QuietMisdreavus)</span></div></div>



<a name="136733088"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136733088" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Sunjay Varma <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136733088">(Oct 29 2018 at 20:29)</a>:</h4>
<p>So basically it's possible, but not very pretty</p>



<a name="136733099"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136733099" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Sunjay Varma <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136733099">(Oct 29 2018 at 20:29)</a>:</h4>
<p>We could potentially just live with the default behaviour of cargo doc</p>



<a name="136733102"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136733102" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Sunjay Varma <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136733102">(Oct 29 2018 at 20:29)</a>:</h4>
<p>It's not <em>too</em> bad</p>



<a name="136733487"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136733487" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> tmandry <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136733487">(Oct 29 2018 at 20:35)</a>:</h4>
<p>I didn't see any examples in the docs where it linked to another crate, locally</p>



<a name="136733494"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136733494" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> tmandry <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136733494">(Oct 29 2018 at 20:35)</a>:</h4>
<p>we can always add the deps later, if needed..?</p>



<a name="136733553"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136733553" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Sunjay Varma <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136733553">(Oct 29 2018 at 20:36)</a>:</h4>
<p>Well any types we use from an external crate will be linked</p>



<a name="136733557"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136733557" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Sunjay Varma <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136733557">(Oct 29 2018 at 20:36)</a>:</h4>
<p>Are you explicitly using the <code>--no-deps</code> flag?</p>



<a name="136733562"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136733562" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Sunjay Varma <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136733562">(Oct 29 2018 at 20:36)</a>:</h4>
<p>If you leave that off cargo will automatically generate the docs for the deps anyway</p>



<a name="136733564"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136733564" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Sunjay Varma <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136733564">(Oct 29 2018 at 20:36)</a>:</h4>
<p>so you can just use that</p>



<a name="136733596"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136733596" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> tmandry <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136733596">(Oct 29 2018 at 20:37)</a>:</h4>
<p>yeah I tried with/without</p>



<a name="136733605"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136733605" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> tmandry <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136733605">(Oct 29 2018 at 20:37)</a>:</h4>
<p>I was just trying to avoid bloat :) I have no problem with leaving them in though</p>



<a name="136733704"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136733704" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Sunjay Varma <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136733704">(Oct 29 2018 at 20:39)</a>:</h4>
<p>It will increase the build times, but I think that's a small price to pay. If you're really feeling up for some experimentation you can try using the travis cache to speed things up. You'd have to add the <code>target/doc</code> directory to the configuration. See the bottom of this blog post: <a href="https://levans.fr/rust_travis_cache.html" target="_blank" title="https://levans.fr/rust_travis_cache.html">https://levans.fr/rust_travis_cache.html</a></p>



<a name="136733713"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136733713" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Sunjay Varma <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136733713">(Oct 29 2018 at 20:39)</a>:</h4>
<p>I would consider that optional though for a first pass at getting this working :)</p>



<a name="136742511"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136742511" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> tmandry <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136742511">(Oct 29 2018 at 22:57)</a>:</h4>
<p>okay, docs are live at <a href="https://rust-lang-nursery.github.io/chalk/doc/chalk/index.html" target="_blank" title="https://rust-lang-nursery.github.io/chalk/doc/chalk/index.html">https://rust-lang-nursery.github.io/chalk/doc/chalk/index.html</a></p>



<a name="136743807"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136743807" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Jake Goulding <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136743807">(Oct 29 2018 at 23:23)</a>:</h4>
<p>It looks like some of the documentation wasn't rendered <span class="emoji emoji-1f608" title="smiling imp">:smiling_imp:</span> (obviously that's the reason some is missing, couldn't be that it wasn't documented to start with)</p>



<a name="136743927"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136743927" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Jake Goulding <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136743927">(Oct 29 2018 at 23:24)</a>:</h4>
<p>But for real, I appreciate that, a lot of times, good Rust code is fairly readable without docs.</p>



<a name="136743982"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136743982" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Jake Goulding <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136743982">(Oct 29 2018 at 23:25)</a>:</h4>
<p>Although this version of rustdoc has an <em>interesting</em> rendering bug:</p>
<p><a href="/user_uploads/4715/1YkkZXfw5Lk7X41M6XHGJzkC/pasted_image.png" target="_blank" title="pasted_image.png">pasted image</a></p>
<div class="message_inline_image"><a href="/user_uploads/4715/1YkkZXfw5Lk7X41M6XHGJzkC/pasted_image.png" target="_blank" title="pasted image"><img src="/user_uploads/4715/1YkkZXfw5Lk7X41M6XHGJzkC/pasted_image.png"></a></div>



<a name="136744290"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136744290" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Jake Goulding <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136744290">(Oct 29 2018 at 23:33)</a>:</h4>
<p>I have mentioned this for the unsafe guidelines, but I'd also heartily recommend adding a glossary of some sort. It could just be a section of the crates docs or maybe the rustc guide. It doesn't need to be all-encompassing, but having links to things would be a great start.</p>



<a name="136744341"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136744341" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Jake Goulding <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136744341">(Oct 29 2018 at 23:34)</a>:</h4>
<p>For example, what is a <em>universe</em> (no need to answer here, add it to the glossary and point me to that <span class="emoji emoji-1f609" title="wink">:wink:</span>)</p>



<a name="136744424"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136744424" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Sunjay Varma <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136744424">(Oct 29 2018 at 23:36)</a>:</h4>
<p><a href="https://rust-lang-nursery.github.io/rustc-guide/borrow_check/region_inference.html#what-is-a-universe" target="_blank" title="https://rust-lang-nursery.github.io/rustc-guide/borrow_check/region_inference.html#what-is-a-universe">https://rust-lang-nursery.github.io/rustc-guide/borrow_check/region_inference.html#what-is-a-universe</a></p>



<a name="136744426"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136744426" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Sunjay Varma <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136744426">(Oct 29 2018 at 23:36)</a>:</h4>
<p>We should definitely have a glossary!</p>



<a name="136745246"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136745246" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Jake Goulding <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136745246">(Oct 29 2018 at 23:57)</a>:</h4>
<p>/me reads the link</p>



<a name="136745248"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136745248" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Jake Goulding <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136745248">(Oct 29 2018 at 23:57)</a>:</h4>
<p>... and maybe an ELI5 glossary</p>



<a name="136746061"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136746061" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> tmandry <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136746061">(Oct 30 2018 at 00:21)</a>:</h4>
<p><span class="user-mention" data-user-id="116155">@Jake Goulding</span>  yes, agreed. a full glossary is on the to do list</p>



<a name="136746103"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136746103" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> tmandry <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136746103">(Oct 30 2018 at 00:22)</a>:</h4>
<p>there <em>is</em> a <a href="https://github.com/rust-lang-nursery/chalk/blob/master/GLOSSARY.md" target="_blank" title="https://github.com/rust-lang-nursery/chalk/blob/master/GLOSSARY.md">glossary in the chalk repo</a>, but could probably use some updates and/or additions</p>



<a name="136746601"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136746601" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Jake Goulding <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136746601">(Oct 30 2018 at 00:35)</a>:</h4>
<p>well then, consider my request to now be to combine the glossaria and then add a link to the final result from the crate docs ;-)</p>



<a name="136746665"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136746665" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Jake Goulding <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136746665">(Oct 30 2018 at 00:36)</a>:</h4>
<p>This one seems to be about what I was looking for, though!</p>



<a name="136791572"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136791572" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> nikomatsakis <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136791572">(Oct 30 2018 at 17:16)</a>:</h4>
<p><span class="user-mention" data-user-id="116883">@tmandry</span> looking at <a href="https://github.com/rust-lang/rust/issues/55100#issuecomment-433504534" target="_blank" title="https://github.com/rust-lang/rust/issues/55100#issuecomment-433504534">your outline</a>, one thing I am not sure about is how/when to talk about "canonicalization". In some sense, the current layering is good, but then canonicalization is also used in the SLG solver implementation internally in order to find the "canonical table" for a given goal etc</p>



<a name="136791588"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136791588" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> nikomatsakis <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136791588">(Oct 30 2018 at 17:16)</a>:</h4>
<p>so I think maybe it wants to move to <code>2.iii</code></p>



<a name="136791889"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136791889" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> tmandry <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136791889">(Oct 30 2018 at 17:20)</a>:</h4>
<p><span class="user-mention" data-user-id="116009">@nikomatsakis</span> ok, do you think it makes sense then to leave "Canonical queries" out as section <code>3</code>? with a link back to canonicalization in <code>2.iii</code></p>



<a name="136791903"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136791903" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> nikomatsakis <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136791903">(Oct 30 2018 at 17:20)</a>:</h4>
<p>hmm</p>



<a name="136791911"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136791911" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> nikomatsakis <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136791911">(Oct 30 2018 at 17:20)</a>:</h4>
<p>I wonder if there are some parts that will be specific to rustc</p>



<a name="136791927"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136791927" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> nikomatsakis <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136791927">(Oct 30 2018 at 17:21)</a>:</h4>
<p>what did you envision going in that section?</p>



<a name="136791938"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136791938" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> nikomatsakis <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136791938">(Oct 30 2018 at 17:21)</a>:</h4>
<p>(it occurs to me that there is some more content that could go after the SLG solver, e.g., aggregation and truncation)</p>



<a name="136791947"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136791947" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> tmandry <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136791947">(Oct 30 2018 at 17:21)</a>:</h4>
<p>which section?</p>



<a name="136791953"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136791953" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> tmandry <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136791953">(Oct 30 2018 at 17:21)</a>:</h4>
<p>I'm not planning on changing canonicalization or canonical queries at the moment</p>



<a name="136792005"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136792005" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> tmandry <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136792005">(Oct 30 2018 at 17:22)</a>:</h4>
<p>for the SLG solver I was going to start with your blog post / the chalk-engine README</p>



<a name="136792040"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136792040" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> nikomatsakis <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136792040">(Oct 30 2018 at 17:23)</a>:</h4>
<p>ok I was thinking that maybe canonicalization can just <em>move</em> and not be its own high-level bullet point</p>



<a name="136792137"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136792137" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> tmandry <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136792137">(Oct 30 2018 at 17:24)</a>:</h4>
<p>yeah, it seems like it makes sense to put it under <code>2</code> somewhere</p>



<a name="136792171"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136792171" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> tmandry <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136792171">(Oct 30 2018 at 17:25)</a>:</h4>
<p>whether it's part of <code>2.iii</code> is just a matter of how we want to break it up</p>



<a name="136792244"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136792244" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> tmandry <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136792244">(Oct 30 2018 at 17:26)</a>:</h4>
<p>this would be the "general operation" of canonicalization, and canonical queries which are rustc-specific can go in <code>3</code></p>



<a name="136792259"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136792259" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> tmandry <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136792259">(Oct 30 2018 at 17:26)</a>:</h4>
<p>..which may grow to encompass more rustc-specific stuff, one day</p>



<a name="136792620"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136792620" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> tmandry <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136792620">(Oct 30 2018 at 17:31)</a>:</h4>
<p>/me curses self for using roman numerals</p>



<a name="136792669"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/136792669" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> tmandry <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#136792669">(Oct 30 2018 at 17:32)</a>:</h4>
<p><span class="user-mention" data-user-id="116009">@nikomatsakis</span> I updated the outline</p>



<a name="137076509"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/137076509" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> tmandry <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#137076509">(Nov 02 2018 at 19:19)</a>:</h4>
<p><span class="user-mention" data-user-id="116009">@nikomatsakis</span> will you proofread <a href="https://github.com/rust-lang-nursery/rustc-guide/pull/222" target="_blank" title="https://github.com/rust-lang-nursery/rustc-guide/pull/222">https://github.com/rust-lang-nursery/rustc-guide/pull/222</a> and possibly <a href="https://github.com/rust-lang-nursery/rustc-guide/pull/223" target="_blank" title="https://github.com/rust-lang-nursery/rustc-guide/pull/223">https://github.com/rust-lang-nursery/rustc-guide/pull/223</a> ?</p>



<a name="137079194"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/137079194" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> nikomatsakis <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#137079194">(Nov 02 2018 at 20:08)</a>:</h4>
<p>I was doing that now</p>



<a name="137079296"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/137079296" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> nikomatsakis <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#137079296">(Nov 02 2018 at 20:10)</a>:</h4>
<p><span class="user-mention" data-user-id="116883">@tmandry</span> where did we publish the chalk rustdocs again?</p>



<a name="137079336"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/137079336" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> tmandry <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#137079336">(Nov 02 2018 at 20:11)</a>:</h4>
<p><span class="user-mention" data-user-id="116009">@nikomatsakis</span> <a href="https://rust-lang-nursery.github.io/chalk/doc/chalk" target="_blank" title="https://rust-lang-nursery.github.io/chalk/doc/chalk">https://rust-lang-nursery.github.io/chalk/doc/chalk</a></p>



<a name="137079896"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/137079896" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Alexander Regueiro <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#137079896">(Nov 02 2018 at 20:21)</a>:</h4>
<p><span class="user-mention" data-user-id="116009">@nikomatsakis</span> fixed the nit you brought up. I'll be around if you have any more requests before you r+ though (or alternatively feel free to make the commit yourself directly.)</p>



<a name="137080589"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/137080589" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> nikomatsakis <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#137080589">(Nov 02 2018 at 20:32)</a>:</h4>
<p><span class="user-mention" data-user-id="131694">@scalexm</span> I left a few nits on <a href="https://github.com/rust-lang-nursery/rustc-guide/pull/222" target="_blank" title="https://github.com/rust-lang-nursery/rustc-guide/pull/222">https://github.com/rust-lang-nursery/rustc-guide/pull/222</a>, would you rather fix them? Nothing major so I am also ok with landing and revisiting later</p>



<a name="137080596"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/137080596" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> scalexm <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#137080596">(Nov 02 2018 at 20:32)</a>:</h4>
<p><span class="user-mention" data-user-id="116009">@nikomatsakis</span> ok I'll fix them</p>



<a name="137081752"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/137081752" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> scalexm <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#137081752">(Nov 02 2018 at 20:51)</a>:</h4>
<p><span class="user-mention" data-user-id="116009">@nikomatsakis</span> done</p>



<a name="148018477"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/148018477" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> tmandry <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#148018477">(Nov 20 2018 at 05:38)</a>:</h4>
<p><span class="user-mention" data-user-id="116009">@nikomatsakis</span> not sure if you wanted to review <a href="https://github.com/rust-lang-nursery/rustc-guide/pull/228" target="_blank" title="https://github.com/rust-lang-nursery/rustc-guide/pull/228">https://github.com/rust-lang-nursery/rustc-guide/pull/228</a> (you wrote most of it :) )</p>



<a name="148059986"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/144729-wg-traits/topic/high-level%20docs/near/148059986" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> nikomatsakis <a href="https://rust-lang.github.io/zulip_archive/stream/144729-wg-traits/topic/high-level.20docs.html#148059986">(Nov 20 2018 at 19:08)</a>:</h4>
<blockquote>
<p><span class="user-mention" data-user-id="116009">@nikomatsakis</span> not sure if you wanted to review <a href="https://github.com/rust-lang-nursery/rustc-guide/pull/228" target="_blank" title="https://github.com/rust-lang-nursery/rustc-guide/pull/228">https://github.com/rust-lang-nursery/rustc-guide/pull/228</a> (you wrote most of it :) )</p>
</blockquote>
<p>merged</p>



<hr><p>Last updated: Aug 07 2021 at 22:04 UTC</p>
</html>